home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / oil103.zip / BBSINFO.DOC next >
Text File  |  1990-12-10  |  12KB  |  254 lines
  1. This document is effective 12/10/90
  2. BBSINFO.DOC
  3.  
  4.  
  5.                  BBS Onliner Interface  version 1.20
  6.                   Copyright (C) 1990 Andrew J. Mead
  7.                          All Rights Reserved.
  8.  
  9.                   Contact:
  10.                        Andrew J. Mead
  11.                        POB 1155
  12.                        Chapel Hill, NC 27514-1155.
  13.                                    or
  14.                        #98 @9968 WWIVnet
  15.                        1:151/223 FidoNet
  16.  
  17.                    Sections (in order of appearance)
  18.  
  19.      General info                -  technical specifications
  20.      - sysop abort                  -  F-9, F-10 overrides
  21.      Command line directives     -  customization
  22.      - get player info              -  BBS data
  23.      - force local mode             -  local override /L
  24.      - comm port override           -  lock comm port /C
  25.      - IRQ override                 -  lock baud rate /I
  26.      - play Again mode              -  allow multiple games /A
  27.      - local quiet mode             -  turn the bell off locally /Q
  28.      - hall of fame limiting        -  limit appearances in HOF /X
  29.      - text HOF rerouting           -  change HOF path/filenames /Y
  30.      - maximum time limit           -  set time limit /Z
  31.      Tech Talk                   -  how to get help
  32.      - upgrade history              -  changes from version to version
  33.      Support and Distribution    -  Where to find the latest test drives
  34.      Special Thanks              -  people who aren't getting paid for this
  35.  
  36.  
  37.  
  38.                           -  General Info  -
  39.  
  40.    This interface is easily installed.  The documentation, however,
  41.    needs help.  The installation of any game using this interface should
  42.    be almost identical to that of any other game also using this interface.
  43.    The /L, /C, and /I switches should not be used unless absolutely
  44.    necessary.  This interface currently works directly with 2 A.M., DoorWay,
  45.    Force, Forum, GAP, GT, ModuleX, PCBoard 14.x, Opus-CBSC 1.14, Phoenix,
  46.    RyBBS, SearchLight, Spitfire, Telegard, WildCat, WWIV, and all the
  47.    various DorInfo.Def BBSs (EIS-PC, FoReM, OLEcom, Quick BBS, RBBS 16,
  48.    Remote Access (RA), TAG, and TP-Board).  PCBoard 12.x and Opus-CBCS 1.13
  49.    are currently in the Beta stage.
  50.  
  51.    See BBSNotes.Doc for extra installation help.
  52.  
  53.    - sysop abort
  54.      The SysOp can end the game in progress by pressing either the F-9
  55.      or F-10 function keys.
  56.    - sysop abort - F-10 override
  57.      The game will be aborted, the user will be notified as such, then
  58.      control will revert to the batch file or BBS.
  59.    - susp[ abort - F-9 override
  60.      This abort will hang up the phone.  To the user, it will appear as
  61.      if line noise had severed the connection.  The program will then
  62.      terminate, and return control to the batch file or BBS.
  63.  
  64.  
  65.                    -  BBS Command Line Directives  -
  66.  
  67.    - command line directives - BBS information
  68.      There is a command line directive to get player info from the BBS.
  69.      The information that the program uses is username, time remaining,
  70.      lines per screen, communications port, and whether the program is
  71.      being run locally or from remote.
  72.  
  73.      2 A.M. BBS     /2                 Auntie BBS     /7
  74.      DoorWay        /D                 EIS-PC         /R#
  75.      Force BBS      /S                 FoReM          /R#
  76.      Forum          /F                 GAP            /S
  77.      GT             /D                 ModuleX        /M
  78.      OLEcom         /R#                OPUS 1.14      /OXX
  79.      PCBoard 14.x   /P                 Phoenix        /H
  80.      Quick BBS      /R#                RBBS           /R#
  81.      Remote Access  /R#                RyBBS          /5
  82.      SearchLight    /9 (see note)      Spitfire BBS   /6
  83.      TAG            /R#                Telegard
  84.      TP-Board       /R#                WildCat!       /W
  85.      WWIV           /4
  86.  
  87.      Note for /R# :
  88.        '#' represents the node number.  If it is missing the filename the
  89.        game uses is 'DoorInfo.Def'.  If it is present, the file name
  90.        is 'DorInfo#.Def' where # is the node number. (i.e. DorInfo1.Def)
  91.  
  92.      Note for /9 (SearchLight) :
  93.        See BBSNotes.Doc for more complete information.  This pathname
  94.        after this directive is the reverse of the other switches listed
  95.        here.  The path should be the path to the directory that the game
  96.        itself is in.
  97.  
  98.      If this command is missing, game will default to LOCAL mode.
  99.      None of the following are yet operational, they will only be supported
  100.         when I get the technical information for them.  If you are
  101.         registering a copy, and want one of these switches to work,
  102.         send a copy of the file your BBS creates, and what lines the
  103.         user's name, their screen length (if available), how much time
  104.         they have left (minutes or seconds), what com port is in use, and
  105.         what baud rate is in effect. A printout is acceptable.  Actually
  106.         most of these create files that I will need offsets for, since
  107.         the information is not seperated by carriage returns.
  108.  
  109.         /U UBBS  /8 Sapphire  /0 XBBS
  110.         This list is not exhaustive.  I'm always looking for more systems.
  111.  
  112.      - alternate file path
  113.      If, for example, your copy of WildCat creates CallInfo.BBS in a sub-
  114.      directory "C:\WC\", and you want to run the game from somewhere else,
  115.      just use the format /?:fullpath, i.e. /W:C:\WC\.  Add a colon and
  116.      the filepath to the directive, and it will work.
  117.  
  118.    - command line directives - force local mode - /L
  119.      You can force the program to use Local mode.  This is designed to
  120.      work with the command above, so that you can play the game locally
  121.      from the BBS.  This will not work with either /C or /I.
  122.  
  123.    - command line directives - communications port override - /C:n
  124.      You can force the program to use a specified serial port.  Use '1' for
  125.      'Com1:', etc...  Example /C:3.  Acceptable values are from 1 to 4.
  126.      This should not be used if one of the above is used.  This will
  127.      not work if either /L or /I is used.
  128.  
  129.    - command line directives - interrupt override - /I:x:nnnn
  130.      You can tailor the game to your specific set up.  This command
  131.      allows you to access any serial port setting.  If you are using
  132.      a non-standard setup, or a PS/2 using Com3 or above, you will
  133.      need to use this.  The default settings, would be equivalent to
  134.      Com1 : /i:4:03f8, Com2 : /i:3:02f8, Com3 : /i:4:03e8, Com4 :
  135.      /i:3:02e8.
  136.      The 'x' is the IRQ number.  It is a hexidecimal value from
  137.      0 to f.  'nnnn' is the port address for communications.  It
  138.      is a 4 digit hexidecimal value.  This will not work if either /L
  139.      or /C is also specified.
  140.  
  141.    - command line directives - play Again? mode - /A:x
  142.      /A:x (/A = /A:10) will prompt the player if he wants to play again
  143.      if he has more than x minutes of game time left.
  144.  
  145.    - command line directives - quiet local mode - /Q
  146.      /Q will keep the bell from ringing on the host.
  147.  
  148.    - command line directives - limited Hall of Fame listings - /X:n
  149.      You can limit the time any one name appears in the monthly top 20
  150.      with this switch.  The default is unlimited appearances.  The
  151.      recommended limit is 1 or 2.  This keeps a small number of players
  152.      from monopolizing the game.  If an occassional (non-fanatical) is
  153.      more likely to see his name listed, he is more likely to play the game.
  154.      n is any number from 1 to 19.
  155.  
  156.    - command line directives - alternate text Hall of Fame - /Y
  157.      You can change where the program creates its text Hall of Fame, and
  158.      what it is called.  All you have to do is use the following format:
  159.      /Y:pathname\filename where the filename is optional.  This will
  160.      Wildcats, for instance, to use /y:c:\wildcat\bull4.bbs where the text
  161.      file is renamed bull4.bbs and placed in the c:\wildcat directory.
  162.  
  163.    - command line directives - set time limit - /Z:x
  164.      /Z:x (x is a number between 10 and 50), sets a maximum time allowed.
  165.      If a BBS file is read then the maximum time will be the smaller of
  166.      this directive and the user's actual remaining time.
  167.  
  168.  
  169.                    -  That's Not My Table  -  Tech Talk  -
  170.  
  171.      The SysOp accepts all responsibility for this programs implementation.
  172.      The Author is not responsible for any damages caused by running these
  173.      programs.  If you are attempting an installation, it is always best
  174.      to TEST the program before opening it up to the public.  Make sure all
  175.      switches are correct.  If you have any technical questions or any
  176.      suggestions, please send a SASE to the above address or contact me
  177.      through E-Mail on the WWIVnet or the FidoNet.
  178.      If you find another system that this runs on/under that is not
  179.      mentioned above, please include that in your regisration.  I am
  180.      always looking for new systems.
  181.  
  182.  
  183.     - changes from StarsBBS 3.0 - StarsBBS 3.5 (Interface 1.0)
  184.      /C switch removed (obsolete).
  185.      /I switch added.
  186.      Error Log file added.  (See Game information for log name.)
  187.      Automatic LOCAL mode detection added.
  188.      SysOp F-10 abort added.
  189.      Current User line added.
  190.      Inactivity time-out fixed.
  191.     - change from 1.0 to 1.02
  192.      /Q quiet local mode added.
  193.      Remote Access capability verified.
  194.     - change from 1.02 to 1.03
  195.      /A replay switch added.
  196.     - change from 1.03 to 1.10
  197.      /F, /M, /H, /5, /6 switches added.
  198.     - changes from 1.10 to 1.13
  199.      beta switches /B (locked baud rate), /P (PCB14.x), and /N (username).
  200.     - changes from 1.13 to 1.14
  201.      /9 added, /B improved, carrier detect routines implemented
  202.     - changes from 1.14 to 1.17
  203.      F-9 added, internal reorginization
  204.     - changes from 1.17 to 1.20
  205.      /P,/O,/1,/7 added
  206.  
  207.  
  208.                 -  Support Boards and Distribution Nodes  -
  209.  
  210.    This is where you can find the latest testdrive versions of my and
  211.    other programmers programs that feature this interface.
  212.  
  213.    BBS Name              Phone         BBS         PCP    SL FR AV  When
  214. +  Bargain Basement BBS  919-220-6058  WildCat     NCRPT  Y  N  N   24hrs
  215. +  Psychotronic BBS      919-286-7738  RA 151/223  NCRPT  Y  Y  N   24hrs
  216.    Social Graces BBS     919-831-2759  WWIV-9954   NCRPT  Y  N  Y   24hrs *
  217.  
  218.    CatHouse BBS          805-395-0650  WildCat            ?  N  Y   24hrs *
  219.    Mustang BBS           SysOps  Only  WildCat            ?  N N/A  24hrs *
  220.  
  221.    Geneal BBS            919-471-6026  RBBS        NCRPT  ?  N  ?   24hrs
  222.    Pheonix BBS           407-451-9845  GAP                Y  N  Y   24hrs
  223.    Wild Zephyr BBS       619-432-0787  WWIV-6962          ?  N  Y   24hrs
  224.  
  225.    PCP - PCPursuit node, SL - StarLink, AV - AutoVerify, When - hours up
  226. *  national or regional support board for given BBS system.
  227. +  guaranteed latest versions available.
  228.    FR - Fido F/REQ available.  I can be contacted on Psychotronic through
  229.    the DoorWare conference echo.
  230.  
  231.  
  232.                           -  Special Thanks  -
  233.  
  234.    Beta Test Sites - the BBS Onliner Interface
  235.  
  236.          Bargain Basement BBS (WCat) - Durham,NC - (919)220-6058
  237.    Another World BBS (WWIV) - Durham, NC - (919)220-6299 - WWIVnet 9968
  238.      Dennis O'Dell and Mollie Moses - SysOps and Bowlers extrodinaire
  239.  
  240.     Thanks also to David Malin, Tom Yates, Rick Guggemos, Brian Cox,
  241.     Jack Holsomback, Shirley Gurley, Richard Lee, and a host of others
  242.     for their time and ideas in helping me make this a fully functional
  243.     interface.
  244.  
  245.                          BBS Onliner Interface
  246.         Copyright (C) 1990 Andrew J. Mead - All Rights Reserved.
  247.               The Mad Programmer - Brown & Mead Consulting
  248.                   POB 1155 Chapel Hill, NC 27514-1155
  249.  
  250.       This interface is currently written in Turbo Pascal 5.5 and
  251.       can be liscensed by other programmers.  Contact me for
  252.       details.
  253.  
  254. END BBSINFO.DOC